1
L'architettura basata su Markdown e l'infrastruttura principale
EvoClass-AI007Lezione 3
00:00

La filosofia del "File come Verità"

La base di OpenClaw è la filosofia Markdown-first. A differenza dei tradizionali sistemi AI a scatola nera, OpenClaw tratta la configurazione come documentazione. Ogni aspetto dell'esistenza di un agente—la sua personalità, le sue capacità e i suoi flussi operativi—è memorizzato in file Markdown leggibili dall'uomo. Ciò garantisce che la "Fonte della Verità" sia trasparente, controllata tramite versioni e facilmente modificabile sia dagli umani che dai modelli LLM.

  • SOUL.md: L'identità centrale e il senso morale.
  • SKILL.md: Il manifesto che definisce cosa l'agente può effettivamente fare.
  • AGENTS.md: Il progetto ingegneristico per l'orchestrazione multi-agente.

Lo stack dell'infrastruttura principale

Per passare da file statici a un agente vivente, OpenClaw utilizza un'architettura backend robusta, progettata per stabilità e flessibilità:

  1. Runtime dell'Agente: La centrale elettrica che gestisce la Coda delle lane. Garantisce che le attività asincrone siano elaborate senza causare Corruzione dello stato, mantenendo Isolamento della sessione attraverso ogni interazione.
  2. Gateway: Il piano di controllo che gestisce l'identità di rete e il routing del modello. Agisce come uno scudo di sicurezza, riducendo i rischi come Esecuzione remota di codice (RCE) sull'API WebSocket.
  3. Layer degli Strumenti: Un'interfaccia modulare dove l'agente si connette a funzioni esterne, API e script locali definiti nel manifesto delle competenze.
  4. Motore indipendente dal modello: Il sistema non è vincolato a un singolo fornitore. Può scambiarsi tra Claude, GPT o modelli locali tramite il openclaw.json router.
  5. Superfici e Canali: Sono i punti di interazione (interfaccia web, terminale o mobile) dove l'agente si manifesta all'utente.
Configurazione: openclaw.json
{ "identità_rete": "agent-01-alpha", "routing_modello": { "primario": "anthropic/claude-3-opus", "riserva": "local/llama-3-8b" }, "iniezione_ambiente": { "secure_pass": vero, "politica": "prevenire_la_fuga" } }
Digita un comando...
Domanda 1
Perché OpenClaw privilegia una filosofia Markdown-first?
Per rendere i file più belli nell'editor di testo.
Per garantire che la configurazione sia la fonte autentica e leggibile dall'uomo della verità.
Per evitare la necessità di un LLM durante l'esecuzione.
Domanda 2
Quale componente è responsabile per prevenire la corruzione dello stato durante le attività multi-agente?
Il Layer degli Strumenti
Il Gateway
Il Runtime dell'Agente (tramite Coda delle lane)
Sfida: Violazione della sicurezza
Mitigazione dei rischi di RCE sui canali pubblici.
Scenario:Stai distribuendo un agente su un canale Discord pubblico. Noti che l'agente sta cercando di eseguire comandi shell non verificati, creando un rischio di RCE (Esecuzione remota di codice) rischio.
Sicuro
Come usi il Gateway e SKILL.md per rendere sicura l'infrastruttura?
Soluzione:
1. Livello Gateway: Limita la porta dell'API WebSocket (18789) al solo traffico locale o implementa token di autenticazione rigorosi.
2. Livello SKILL.md: Definisci permessi stretti nei metadati YAML per il Layer degli Strumenti.
3. Livello Istruzioni: Aggiorna il Filtro a sei livelli nel manifesto delle competenze per rifiutare qualsiasi stringa di comando che contenga operatori shell sensibili.